home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / restart3.zip / RESTART.DOC < prev   
Text File  |  1990-09-24  |  6KB  |  187 lines
  1.                    RESTART
  2.  
  3.             Instructions for RESTART.COM
  4.  
  5. This is the second version of the RESTART.COM program that I wrote in
  6. 1988, one afternoon. It is a somewhat more flexible version.
  7. I contribute this program to the Public Domain. 
  8.  
  9. Tom Almy
  10. toma@tekgvs.labs.tek.com
  11. May 26, 1990
  12.  
  13. Improvements:
  14. - commentary text after first line possible
  15. - more than one config name can be given
  16. - more and more instructive error messages
  17. - now white space(s) separate config names from lines to write
  18. - white space removed around input and output lines
  19. - empty lines allowed and ignored in configuration file
  20.  
  21. Thomas Birnthaler
  22. birnthal@forwiss.uni-erlangen.de
  23. Aug 25, 1990
  24.  
  25.  
  26. Improvements:
  27. - additional config names can be defined based on presence or absence
  28.   of other config names
  29. - more error messages
  30. - added cold boot option
  31.  
  32. Tom Almy
  33. September 24, 1990
  34.  
  35.  
  36. DESCRIPTION
  37. -----------
  38. Restart is a system configuration management program. The conflicts
  39. of many device drivers, tsrs, tradeoffs on ramdisks, etc, was driving
  40. me nuts having multiple CONFIG.SYS and AUTOEXEC.BAT files to maintain
  41. and copy. Restart maintains all the configurations in a single file,
  42. CONFIGUR.DAT. This file contains a list of allowable configuration
  43. names followed by descriptions of the contents of any number of files
  44. (typically CONFIG.SYS and AUTOEXEC.BAT in the root directory of the
  45. booting drive, but can also be used for command alias files, altering
  46. batch files, etc.). The file descriptions are lines to be included in
  47. the file. Lines can be conditionally included or excluded based on
  48. the configuration name.
  49.  
  50. After the files are created, restart can reboot the system. A time
  51. delay can be specified for systems using staged-write disk caching.
  52. Other options disable the reboot, or writing what would be the file
  53. contents to the display rather than to the files (for debugging).
  54.  
  55.  
  56. THE COMMAND LINE
  57. ----------------
  58. RESTART 
  59.  
  60. with no arguments gives a short message on the allowed arguments,
  61. a list of all possible configurations, and all the (commentary) text
  62. before the first *filename in CONFIGUR.DAT.
  63.  
  64.  
  65. RESTART <config> ...
  66.  
  67. will create files for configuration(s) "<config> ...", and then reboot the
  68. system. More than one configuration is allowed.
  69.  
  70.  
  71. RESTART -n <config> ...
  72.  
  73. same, but won't reboot the system.
  74.  
  75.  
  76. RESTART -c <config> ...
  77.  
  78. same, but does cold reboot, like when powered up, rather than warm (soft)
  79. reboot, like ctrl-alt-delete.
  80.  
  81.  
  82. RESTART -s <config> ...
  83.  
  84. writes what would be the file contents for configuration(s) "<config> ..."
  85. to standard output (you might want to pipe the output through MORE).
  86.  
  87.  
  88. RESTART -4 <config> ...
  89.  
  90. delays four seconds before rebooting (any integer delay, in seconds,
  91. can be specified).
  92.  
  93.  
  94. THE CONFIGURATION FILE
  95. ----------------------
  96. The configuration file, CONFIGUR.DAT, is expected to be found in the
  97. root directory of the boot drive (It looks at the first character of
  98. the COMSPEC environment variable to decide which drive is the boot
  99. drive). If the environment variable BOOTDRIVE is defined, then the
  100. first character of that variable specifies the bootdrive.
  101.  
  102. - The first line of the configuration file specifies the allowable
  103.   configurations. Configuration names are separated by apostrophes, and
  104.   apostrophes are used at the beginning and end of the line as well. No
  105.   white spaces or other extraneous characters are allowed. For instance,
  106.   my first line looks like this:
  107.  
  108.       '386'med'noram'small'c++'max'c60'
  109.  
  110.   listing seven possible configurations.
  111.  
  112. - Zero or more lines of commentary text follow, describing e.g. the
  113.   possible configurations. This commentary text ends before the first
  114.   line specifying a file to generate.
  115.  
  116. - Zero or more subconfiguration lines (may be mixed with commentary text).
  117.   These lines follow the format of the conditionally included lines 
  118.   described below. As an example, the line:
  119.  
  120.       'a'b' ramdrive
  121.  
  122.   will define the configuration ramdrive if either configuration a or
  123.   configuration b have been defined. This allows the use of 'ramdrive'
  124.   rather than 'a'b' in conditional lines, and can be more descriptive.
  125.  
  126. - At least one line must specify a file to generate. Lines
  127.   specifying files start with an asterisk. File names need to be
  128.   specified with full drive and pathnames. My first file line is:
  129.  
  130.       *c:\config.sys
  131.  
  132.   The lines that follow, up until the next file specification line or
  133.   end of file, describe the lines which go into that file.
  134.  
  135. - If a line starts with a list of one or more configurations, followed
  136.   by one or more white spaces, then that line is only included for those
  137.   configurations. For instance,
  138.  
  139.       'noram'small' shell=c:\4dos.com /s:dc:\temp /p
  140.  
  141.   The line starting at "shell" is only placed into the file if the
  142.   configuration is noram or small.
  143.  
  144. - A line that starts with a tilde is handled in the same manner, but
  145.   with the sense reversed. For instance,
  146.  
  147.       ~'noram'small' shell=c:\4dos.com /s:dk: /p
  148.  
  149.   is only placed in the file if the configuration is not noram or
  150.   small. In this case, it would be equivalent to:
  151.  
  152.       '386'med'c++'max'c60' shell=c:\4dos.com /s:dk: /p
  153.  
  154. - By having a line that cannot match any configuration, you can have
  155.   comment lines in the CONFIGUR.DAT file:
  156.  
  157.       '' THIS IS A COMMENT LINE
  158.  
  159. - A line that starts with neither * ' nor ~ is always written
  160.   to the file.
  161.  
  162. - Empty lines are skipped, leading and trailing white space is removed
  163.   from input and output lines.
  164.  
  165.  
  166. Here is a small sample CONFIGUR.DAT file:
  167. -----------------------------------------
  168. 'clean'small'large'
  169. commentary text
  170. clean: maximum free memory
  171. small: small system
  172. large: large system
  173.  
  174. ~'clean' notclean
  175.  
  176. *c:\config.sys
  177. 'notclean' driver=\sys\mouse.sys
  178. 'large' driver=\sys\fastdrive.sys 1024
  179. 'large' buffers=5
  180. ~'large' buffers=10
  181.  
  182. *c:\autoexec.bat
  183. 'large' pcshell/r
  184. 'notclean' neattsr/p/q
  185. PATH=\bin;\dos
  186.  
  187.